title: Device (Python) description: Python-side Device API mirroring the JS Device namespace: read-only model / system / screen / battery / orientation / locale info.

The scripting Python package exposes Device with read-only properties describing the host device — model, system version, screen, locale, battery, and orientation. Each property fires a single RPC call to fetch the current value; cache the result yourself if you read the same property in a tight loop.

import scripting; Device = scripting.Device

print(Device.model, Device.systemName, Device.systemVersion)

#Properties

#Hardware identity

#Screen

#Battery & sensors

#Orientation

#Locale

#Examples

#Detect iPad / portrait layout

import scripting; Device = scripting.Device

if Device.isiPad and Device.isLandscape:
    print("Render the wide layout")
else:
    print("Render the narrow layout")

#Battery status

import scripting; Device = scripting.Device

state = Device.batteryState
level = Device.batteryLevel
print(f"Battery: {int(level * 100)}% ({state})")

#Localized greeting

import scripting; Device = scripting.Device

primary = (Device.preferredLanguages or ["en"])[0]
greeting = "你好" if primary.startswith("zh") else "Hello"
print(greeting)